home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmeStandardTargets.z
/
XmeStandardTargets
Wrap
Text File
|
1998-10-30
|
8KB
|
133 lines
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss - A toolkit function that returns a list
of standard targets
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/TransferP.h>
AAAAttttoooommmm **** XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(
WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
iiiinnnntttt ccccoooouuuunnnntttt,
iiiinnnntttt ****ccccoooouuuunnnntttt____rrrreeeettttuuuurrrrnnnn);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
Use XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss to return a list of the targets that
your widget can convert. XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss is usually
called from an XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkprocedure or from the
ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method of an _X_m_Q_T_t_r_a_n_s_f_e_r trait, typically
in response to a request to convert a selection to _T_A_R_G_E_T_S.
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss carves out enough dynamic memory to hold
a list of all the AAAAttttoooommmms your widget can convert. This list
will consist of the ten standard targets plus any additional
nonstandard targets supported by your widget. Use the _c_o_u_n_t
argument to specify the number of nonstandard targets
supported by your widget. Then, XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss seeds
the first ten entries in this list with the following ten
standard targets:
+o _B_A_C_K_G_R_O_U_N_D
+o _C_L_A_S_S
+o _C_L_I_E_N_T__W_I_N_D_O_W
+o _C_O_L_O_R_M_A_P
+o _F_O_R_E_G_R_O_U_N_D
+o _N_A_M_E
+o _T_A_R_G_E_T_S
+o _T_I_M_E_S_T_A_M_P
+o ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
+o ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY
Every Motif widget that acts as the source of a data
transfer must be able to convert all the standard targets.
Page 1 (printed 10/24/98)
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss((((3333XXXX))))
(See XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3) for details.)
After XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss returns, the conversion routine is
responsible for adding the _c_o_u_n_t additional items to the end
of the returned list, beginning with the _c_o_u_n_t__r_e_t_u_r_n
element.
_w_i_d_g_e_t Specifies the reference widget for the conversion.
_c_o_u_n_t Specifies the number of additional targets, beyond
the standard targets, that the widget supports.
_c_o_u_n_t__r_e_t_u_r_n
Returns the number of standard targets at the
front of the returned list of targets.
RRRREEEETTTTUUUURRRRNNNN
This routine returns a list of AAAAttttoooommmms. The routine puts
standard targets at the front of the list, and the list
contains an additional _c_o_u_n_t atoms at the end that are
allocated but not filled in.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3),
XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3),
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3), and XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
Page 2 (printed 10/24/98)